home *** CD-ROM | disk | FTP | other *** search
/ WH Questions 2 / WebberInteractiveWHQ&ALevel2.iso / Xtras / PrintOMatic Lite MX (Win32) / -PrintOMatic Lite MX Demo.dir / 00020_Field_20.txt < prev    next >
Text File  |  2004-04-06  |  3KB  |  66 lines
  1. Appending to a Document
  2.  
  3. The following commands are used to append text and graphics to a PrintOMatic Lite document.
  4.  
  5.     append        appends contents to the current frame
  6.     pageBreak        inserts a page break in the text flow
  7.  
  8. append
  9.  
  10. Syntax:    append document, member whichCastmember [, ... , autoAppend ]
  11.         append document, member whichCastmember of castLib whichLib [, ... , autoAppend ]
  12.         append document, castLib whichCast [, ... , autoAppend ]
  13.         append document, sprite whichSprite [, ... , autoAppend ]
  14.         append document, string [, ... , autoAppend ]
  15.         append document, list [, ... , autoAppend ]
  16.  
  17. The append command appends one or more items to the current "frame" of a document object. If no current frame exists in your document, the PrintOMatic Xtra will attempt to create a "default" frame for you, which is the width and height of the page, minus the current margins.
  18.  
  19. The autoAppend parameter, which is always the last parameter in a call to append, controls whether or not new pages will be created "on the fly" if the PrintOMatic Xtra runs out of space on the last "frame" in your document. If this parameter is set to TRUE, new pages will be created with the same "frame" layout as the last page of your document. PrintOMatic will create as many new pages as are necessary to flow all the specified elements into your document . If this parameter is not specified when you call append, its value defaults to TRUE.
  20.  
  21. AutoAppending is not allowed when flowing items into a frame on the master page of a document.
  22.  
  23.     type of object          what gets appended
  24.     _________________________________________________________________
  25.  
  26.     text field cast member  the text of the field, using the 
  27.                             specified fonts and styles
  28.  
  29.     rich text cast member   the bitmap image of the cast member,
  30.                             including anti-aliasing
  31.  
  32.     bitmap cast member      the cast member graphic
  33.  
  34.     PICT cast member        the cast member graphic
  35.  
  36.     cast library            all printable cast members in the 
  37.                             library, in cast sequence
  38.  
  39.     sprite                  the cast member of the sprite
  40.  
  41.     text string             the text string, in the default font 
  42.                            (Geneva 10pt on Macintosh, 
  43.                             Arial 10pt on Windows)
  44.  
  45.     list                    the elements in the list
  46.  
  47. Example:
  48.  
  49. The following example creates a PrintOMatic document, sets the document name, creates the first page, adds a frame to it, and appends a number of items to the document, and prints it:
  50.  
  51.     set doc = new(xtra "PrintOMatic")
  52.     if not objectP(doc) then exit
  53.     setDocumentName doc, "My Example Document"
  54.     newPage doc
  55.     newFrame doc, Rect(0,0,getPageWidth(doc),getPageHeight(doc)
  56.     append doc, sprite 1, TRUE
  57.     append doc, [member "image", member "caption", sprite 5], TRUE
  58.     append doc, castLib "printout", TRUE
  59.     if doJobSetup(doc) then print doc
  60.     set doc = 0
  61.  
  62. pageBreak
  63.  
  64. Syntax:    pageBreak document
  65.  
  66. Stops the text flow on the current page. All text appended after calling pageBreak will start on the next page.